M A D 



(Micro -As sembl e r/Disa s sembler ) 

MAD consists of two subprograms, the first is the assembler 
which converts your source code into machine code which car. 
be understood by the G80^ micro —or icsssor, j.*sC socona pare 
of tti\D is the Gis-ast>e.'.ibier which tjOiiverLs ruaCiiiiie coue 
stored in RAM back into source code. 

The advantages of using MAD over higher level languages such 
as BASIC, or PASCAL are firstly that the resulting programs 
run faster than their high level language counterparts, and 
second! v that they take xip a much smaller area in RAM. 

The MAD eprom resides at address 000 and is designed to 
interface with a debug eprom. 

ASSEMBLY ... 

Once the MAD eprom is in place, and the Pegasus turned on, 
the menu should show "Assembler" as one of the options. ' - 
Simply type 'A' to invoke the assembler and it will then 
prompt- for a starting address which should be given in the" 
form of a four digit hexadecimal value. . . 

At the beginning of each line, the hexadecimal address; at 
which you" are assembling is displayed. To leave the a's'sembli-: 
type the (break) button which will return you to the menu. 
"Otherwise the assembler will wait for a source code line. 

Entering a - Sou rce Line 

This is giver, in the form of a mnemonic, immediately foilov.-v 
by the register -designation if there is ~-no (i.e. a regist;- 
lable from the list: A, B,-C,D, S, i\-X.. or V: where C represent r 
the c end it ion code register) . Tiii-n type a space and Lhe 
assembler will rep.lv "HUH?" if they are an impossible cor ■in- 
at ion, otherwise it will check to see if they are inherent, 
if so then the next line will be displayed and a scarce coco 
line will bs expected as before. 

E.G. I ROM L'.0£# 

BW;> TS7A (yn) 

B0P1 UT7-- (::■}■) 

HUH? 

P.O.O'J r.Ti> Up) 

y.j'i',\ <h: caM 

{return*-: Lo 0.i .*"!.>}. .\y menu) 



If the command was not inherent then the cursor will move 
.ho the right, and the assembler will wait for an operand. 
The Oar. ts of a source line are as follows: 



B00 CMP A BC34 

Address Mnemonic Register-designation Operand 

again, end the argument with a space and the assembler will 
attempt to assemble the instruction and either return 
"HUH?" or wait for the next source code line. 

E.G. B$00 1-DA $30 Load the A accumulator with B0 

. (base 16) 
B002 BTS Incorrect mnemonic 

HUH? Assembler returns for correct line 

Bj$02 BITA B30 ,Bit with contents of location B300 
B05-5 ■ 

Regis ter -de si gna t ions •■-. '..'-• • •'-.".'... 

The optional register immediately following the mnemonic 
can be an accumulator (A,B, or ~D) , and index register 
(>;, or Y), a stack pointer (S, or U) , or the condition 
code register (C) . ...,-.■ ■ ••' - ;, ... 

Note that in a transfer;, or exchange - instruction there is no 
register designation, and that the two registers involved 
comprise the operand. ' ■ .* *. 

Operands . • ' - ■';'.'..' 

Instructions can be one of seven basic types: 

--..' v-.- ..■ x~i."ii"icdia' ! ' e B>" 4 "'~d"d Dircc 4- - ^eci-stex. P.e.lati T? e.- 
o?; Indexed. '• -.-,• '• ■-•' 

The type of the instruction specifies the form of operand 

. la S cCt • \ 

inherent ■ ■.'■-' 

Inherent has no operand, the assembler will not prompt for 
one. The mnemonic and the optional register designation 
comprise the complete instruction. . - 

E.G. B000 SYN .Synchronise to interrupt 

B0-01 COMA .Compliment the A accumulator 

$1002 SW3 .Software interrupt 3 

BJ304 



Immed i ate 

Immediate addressing is specified by a # at the beginning 
of the operand. It means that the operand specifies a 
particular value to be used, not the address at which it 
can be found, s. 

In all castjj on operand must be specified fcr an immediate 
instruction. Various commands v:hich are available in most 
addressing modes are not available in immediate mode as 
they would be meaningless - e.g. STA £30, or COM #16. 

The argument need. not be a hexadecimal value, it can also 
be one or two ASCII characters. This is defined by a 
" immediately following the # and the number of characters 
should correspond to the size of the register. 

i.e. for a 26 bit register use two characters" and for an 
8 bit register use only one character. Remember that these 
characters will have the most significant bit set to 0. 

E.G. B&00 LDA #30 . Load the A. accumulator with 30 (HEX) 

B.0.02 CWA £20 . And the condition code register with 

. 20 and wait for interrupt 

K004. LDD #1010 . Load D with 1010 hex 

B001 LDA #"F ". Load A with ASCII, character 'F' 

(=46hex) 

B009 LOS #"EG . Load S with 'EG' 

. Note that this is a suicidal instruction 

BppD COM -jHOOO . Impossible instruction 
HUH? 

Ex ten de d Ac c ; r e s sing 

Extended addressing defines an absolute address and is signified 
by a four digit hexadecimal number, which is used as an address. 
The byte which is stored at that address will be changed or 
used. See DIRECT, and SET. 

E.G. BOO-0 COM B300 Compliment byte at B300 

BO 3 LDA B300 Load A from B300 

B006 STD 1000 Store D at 1000 and 1001 (combined) 
B009 

Direct Addre ssing 

Direct addressing produces only one postbyte unlike extended 
addressing which uses two, thus direct addressing is more 
compact in i?AFL The most significant byte of the address is 
defined by the direct page register. For both direct and 
extended addressing, type the full four character hexadecimal 
address then the assembler will compare the most significant 



byte of the address with the direct page register defined 
in the SET command. If the most significant byte corresponds 
then direct addressing will be used, otherwise extended will 
be used 1 . If you type a <C before the address then direct 
addressing will be used meaning that you are responsible 
for the direct page register holding the correct value. 
Likewise a > sign before the address will force extended 
addressing regardless of the direct page register. 

E.G. BOOO LDA #10 

■RO0? •yvn AfTW "Put 3 into direct page register 

B004 SET 10 Inform assembler that it can 

expect the direct page register 
to be 10 
B>004 LDA 1632 Load A from 1632 - extended 
D007 STA 1032 Store A at 1032 - direct 
B009 LDS >1032 Load A from 1032 - extended 

(extra byte used unnecessarily) 
BO0C STA <1632 Store A at 1632 - direct 

(actually this will access 1032 
NOT 1632) 

Regist e r Addr essing 

Register' "addressing is used by the PSH, PUL, TFR, and EXG 
instructions. Transfer and exchange are both followed by 
a pair of equally sized registers separated by a comma. It 
should be noted that the assembler will not detect different 
sized registers and will attempt to assemble, but the 
disassembler will show an error if two unequally sized 
registers are transferred or exchanged. 

The operand of Push or Pull instruction consists of a series 
of varied length registers separated by commas and may not 
contain the register pointing to the stack being used. 

Only the direct page register is referred to by two characters 
while the rest, are represented by a single letter as follows: 
A,B,C,D,X,Y,S,U,P, or~DP 

E.G. BOOO TFR A, 3 - Put A into B without changing A ' 

B0 0-2 EXG B,X Exchange two different sized 

.registers vrtiich is impossible. 

B004 EXG D,X Exchange the content of D, and X 

B006 PULS A,E,U Pull A,B,and U, off the S stack 

B008 PSIIU D,S Push D, and S onto user stack 
B00A 

Relative Addressing 

Relative addressing is used by the branch instructions, and 
requires a one or two byte offset for short or long branches 
respectively. Simply type the address to be branched to as 
the opex-and and the assembler will decide upon whether a 
short" or long branch is required depending upon the di f f erence 
between the current address and the address being brarched to. 



E.G. • 


BOOO 


BRA 


■BOOC 




B002 


" BRA 


>B00C 




BO 0-5 


BPA 


f ! o 




BOOS 


BRA 


<0000 


Indexed addr 


assir.a 





J - 



As for direct/ex Landed decisions the assembler can be 
forced to use a small branch by a <^sign preceding the 
address, oi a long branch can be forced by a^ sign. 

Short branch to BO 00 
Long branch to BOOO 
T.nng branch to 0000 
.Short, branch supposedly to 0000 
but will actually equal BRA B00O 



The assembler uses indexed addressing as specified by Motorola 
barring a few exceptions. Firstly, as this assembler always 
assumes a hexadecimal value, . the $ used by them is unnecessary 
but the values A,b, and D(10,ll, and 13 in decimal) must be- 
specif ied as: 0A, 0b, and Od so that the assembler will 
recognize them as offsets rather than the registers A,B, and 
D. 

Another difference between MAD indexed modes and Motorola 
modes is that, PCR for program counter relative is shortened 
to ,P. The final difference is that you can request 8, or 16 
bit postbytes. I'd force a 16 bit offset to be used, precede ' 
.the whole operant with a ) . To request an 8 bit postbyte a "• 
< sign should be used. 

, X Assembler uses bit offset 

-1,X . Assembler uses 5 bit offset 

<£5F,X Assembler uses 8 bit offset 

3333, X Assembler uses 16 bit offset 

BOOB LDA ,X Forces 8 bit offset (i.e, LDA 00, X) 

B00D LDA >,X Forces 16 bit off set (i.e. LDA OOOQ,X) 

Assembl e r_ D i rect i yes 

Other than the standard set of mnemonics avaialble in the 
6809 there are fiv*» assembler directives to give the assembler 
instructions which are themselves not encoded into RAM but 
are Operated upon instead, these are: FCB, FCC, SET, ORG 
and D'lS . 

FCB , 

FCB (form constant bytes) is used to store hexadecimal values, 
the final one terminating with a space. 

E.G. B005 FC3 27,3B,(sp) Places the two bytes into RAM 

BO 07 Note that the commas are automatic 



E.G. 


BOOO 


LDA 




B002 


LDA 




B004 


LDA 




B0 07 


LDA 



FCC 

FCC (Form constant characters) is used to put a sequence 
of characters into RAM, it will echo a "symbol befcre 
the string. Note that spaces cannot be created by this 
command and should be done by FCB 20. 

E.G. BOOO FCC "Hello Places characters H,e,l,l, and 
B0u5 . in KAi-1 with most siguifiucuiu 

bit — 

SET 

SET (Set direct, page register) . This directive is used to 
inform the assembler where it can assume the direct page 
register to be. The assembler will use this to decide upon 
whether it can use direct or extended addressing, as 
discussed under DIRECT. When the assembler is ...initially 
started the direct page^ register is assumed to be pointing 
to 00, so unless you have. defined the direct page register, 
any addressing of the 00 page should be forced to be 
extended. 

E.G. B000 LDA 0033 .. ".." ■ . 

Remember that the SET command does not affect the direct 
page register as such, and this. can only be done using a 
register mode instruction. 

E.G. BOOO SET B3 Informs the assembler that it can 
BOOO assume the direct page register 

to be B3 

ORG ' 

ORG (origin) changes the address at which you are assembling 
without; affecting the memory into which you are about to 
assemble. 

E.G. B080 ORG BOOO Stop assembling at B080 
BOOO and continue at BOOO 

PIS , 

DIS (Disassemble) enables you to invoke the disassembler 
without leaving the assembler. The start and end addresses 
are requested as usual for disassembly, and when the 
disassembly is finished, or a (break) is typed control is 
returned to the assembler without changing the address at 
which you were assembling. 



BQOO 


DI 


G 


FORK? 


BO 


20 


TO? 


BO 


20 


BO 20 


ME 


Q 


3000 







E'.'G. BQOO DIG Invoke disassembler 

Start disassembling from B020 
Stop disassembling after B020 
oo Output from disassembler 



Lables ^ 

Stored in MAO, is the complete list of user system monitor 
subroutines end system RAM allocation as defined elsewhere 
in the manual, whan using these subroutines and RAM locations 
you are do not need to remember the address at which they 
reside. 

To use these addresses simply type the first four letters of 
the location or subroutine desired instead of its address. 

To use these addresses simply type the first four letters 

of the location or subroutine desired instead- of its address. 

E.G. BO-00 LDA INBU Load A from input buffer 
B0 03 JSR ECHO Echo character 
B006 

Note as you type this that after each line the label is 
removed and the hexadecimal address is inserted instead so 
do not type -acre than -the first four letters. The labels 
stored in MAD can only be used for immediate direct, extended, 
and extended- indirect instructions. Contrary to the method^ 
shown in the system monitor subroutine list you do not need 
to jump via a lookup table. 

i.e. instead of typing JMP P800 
simply type JMP ECHO 

This means that the labels will rarely -used other than in 
direct mode. ... , 



DISASSEMBLY 



The Disassembler is used to convert machine code stored in 
RAM into source code as would have been entered into the 
assembler with a few. minor differences. 

To start the disassembler ensure that the MAD EPROM is in 
place and that "Disassembler" appears. in the menu, then 
type D and it will prompt for start and end addresses to 
be given in the form of two four digit hexadecimal values. 

The first visible differences are that any ASCII characters 
that have been typed in under immediate mode will appear 
as hexadecimal. Long and Short .branches will be indiscernabi; 
other than by examining the differences between the addresse: 



of two adjacent instructions, anything entered under the 
FCB, or FCC. directives will appear ridiculous instructions, 
and direct instructions will only give the least significant 
byte as the address. 

The final difference is that in PS.H or PUL instructions the 
registers will appear in a specific order-, not that which 
you specified, and the D register will appear as A,B. 

If an impossible instruction is disassembled the mnemonic 
will appear as *** followed by the hexadecimal equivalent 
of the first byte of the instruction then the disassembler 
will attempt disassembling from the next byte onwards. 



(cr) 



The following program will repeatedly output alphabets until 
the (break) key is typed. ... 



Load "A" into the A accumulator 
Echo the character to the screen 
Increment the character 
Is the end of the alphabet reaches 
If not then echo next character 
wwiisrwiSc rossi. A and continue 



Then type BG00(.) (the address of the program) 



E.G. 


FROM? 


BOOO 




TO? 


BO 01 




BO 


*** 72^ 




BO 01 


LDA , X+ 




(return 


s to menu) 


Exampl 


e Program 



A 










FROM: 


i 


BOOO 






BOOO 




LDA . 


#"A 




BO 02 




BSR 


ECHO 




BOOS 




I'wCA 






B0 0-5 




" CMPA 


#"Z 




B003 




BLS 


B 02 




B A QA 




DJ1A 


B0C0 




B00C 




{break: 


I 








(returi 


is to 


MEND'} 


Type 


M 


to enter 


Monitor 


Type 


G 


to start 


program 



